Because debugging and writing debug information to a log file is time consuming and expensive, Barcode Xpress provides the ability to control the level of information written to the debug log as well as the ability to turn off writing to a file completely.
Use the objects below to adjust the settings of your debugging, event handling, memory and IDispose for optimal performance.
Control Debugging Information
- Debug - Turns on or off the ability to write to the debug log file.
- DebugLogFile - A filename which stores the debug log information.
-
DebugErrorLevel - Controls the amount of information that is written to the debug log file.
When DebugErrorLevel is set to Detailed, Barcode Xpress will log most of your calls to the component including the occurrence of exceptions, the result of most major operations and the operation of each event it raises.
Troubleshooting
-
Color or Grayscale Images - Barcode Xpress works with 1, 8, or 24-bit images. To convert other formats, use the ColorDepth or other methods with the included ImagXpress component.
-
Due to poor image quality, not able to read Barcodes when you know they exist - There is no set process for cleanup of images. Since literally a single pixel may make a difference for recognition results, what may work on one image for cleanup, may not work on another. The ScanFix component, which is sold separately, can perform various clean-up operations including SmoothandZoom, Dilation, and Erosion which all assist in recognition of the barcodes, but there is no set order in which to perform these operations that will ensure each image barcode will be detected. All ScanFix Xpress (sold separately) cleanup operations are very fast, so an option to consider is performing multiple operations and then retrying recognition. Some image clean-up operations can also be found in ImagXpress.
- Issues with barcode recognition - Some reasons why your barcode may not be detected could be due to poor resolution, resolutions of horizontal and vertical are not the same (such as a faxed image), the barcode wasn't made correctly according to the standard, bad scanning quality, bad image quality (see bullet two above), or the barcode is a type that Barcode Xpress doesn't read. Attempt to solve any image quality, resolution, and scanning properties using the included ImagXpress component. ImagXpress can be used to set both horizontal and vertical resolutions the same.
-
Confidence values - Confidence values are programmed into the component. Barcode Xpress is conservative on confidence values compared to other competitive components so the developer understands when a barcode may not be 100% accurate. This ensures the barcode recognized is producing accurate data.
Error Codes
Listed below is a cross reference of error codes and their corresponding descriptions.
Error Codes | Error | Description |
9000 |
OUTOFMEMORY |
There is not enough memory to continue the operation. |
9001 |
INVALIDPARAMETER |
Invalid parameter. |
9002 |
PARAMETEROUTOFRANGE |
Parameter out of range. |
9003 |
INVALIDBITMAP |
Invalid bitmap. |
9004 |
UNABLEREADBITMAP |
Unable to read bitmap. |
9005 |
UNSUPPORTEDBCTYPE |
Unsupported barcode type. |
9006 |
INVALIDINDEX |
Invalid index. |
9007 | INVALIDBARCODEVALUE | Invalid barcode value set. |
9008 | INSUFFICIENTWIDTH | Insufficient barcode width. |
9009 | INSUFFICIENTHEIGHT |
Insufficient barcode height. |
9010 |
UNABLECREATEUPCE |
Unable to create UPC-E Barcode. |
9011 |
INVALIDLICENSE |
Invalid license. |
9012 |
TIMEOUT |
Timeout Error. |
9013 |
IMAGENOTAVAILABLE |
Image not available. |
9014 |
INTERNALERROR |
Internal error. |
9015 |
INVALIDAREA |
Area is outside required range. |
9016 |
UNABLEREADCBBITMAP |
A bitmap could not be retrieved from the clipboard. |
9017 |
INVALIDDBDIMENSION |
The clipboard image has invalid dimensions. |
9018 |
UNABLEOPENCLIPBOARD |
The clipboard could not be opened. |
9019 |
HDIBNOTSET |
The hDIB property was not set. Please set it or adjust the ImageSource property. |
9020 |
PICTURENOTSET |
The Picture property was not set. Please set it or adjust the ImageSource property. |
9100 |
StatusPDF417EncodingError |
PDF417 encoding error. |
9101 |
StatusRowCountError |
Invalid row count for the barcode type. |
9102 |
StatusColumnCountError |
Invalid column count for the barcode type. |
9104 |
StatusLargeDataError |
Barcode data too large for the barcode symbol size. |
9105 |
StatusInvalidErrorCorrection |
Error correction level is invalid. |
9106 |
StatusErrorCorrectTooHigh |
Error correction level is too high, will not fit in barcode symbol with the data. |
9200 | StreamParseException | An error was encountered while parsing the stream data in the ReadFromStream method. |